home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / tbbs / evnts102.zip / EVENTS.DOC next >
Text File  |  1996-04-19  |  6KB  |  150 lines
  1. ┌────────────────────────────────────────────────────────────────────┐
  2. │                              Events!                               │
  3. ├────────────────────────────────────────────────────────────────────┤
  4. │                           By Tony Fardella                         │
  5. │                             tonyf@crl.com                          │
  6. └────────────────────────────────────────────────────────────────────┘
  7.  
  8. ===========
  9. What is it?
  10. ===========
  11.  
  12. Events is a prgram I started writing about a year or so ago. It displays
  13. a pretty good monthly calendar that you can easily navigate using cursor
  14. keys. By selecting any date you are brought to a weekly view that allows
  15. you to select any day of the week. On each day there will be a list of
  16. events for that day that you can select and look at.
  17.  
  18. You can add new events in either the month view or the week view. You can
  19. edit and delete existing events from the week view. These options are only
  20. available to users with priviledge level 200 and up.
  21.  
  22. =================
  23. How to Use Events
  24. =================
  25.  
  26. To use the program just put the EVENTS.TPG file into it's own directory. You
  27. can then simply add an SDL entry to your menu that look something like the
  28. following:
  29.  
  30. Entry:
  31. 1. View the Calendar
  32. KEY=1
  33. TYPE=200
  34. OPT DATA=c:\events\events /q && <optional title> </min edit level>
  35.  
  36. If you use the title option the text after the two ampersands (&&) will be
  37. used in the header on the Monthly and Weekly views.
  38.  
  39. The minimum edit level determines what user level is necessary to add, edit
  40. or delete events in the database. This should be a number from 0 to 254.
  41. If this parameter is missing the minimum edit level will be set to 200. Users
  42. with a privilege level lower than the minimum will not see the Add, Edit or
  43. Delete commands in the help screen.
  44.  
  45. The program will create a file named EVENTDB.DBF which contains the event
  46. database. While the program is running it will also create a couple of other
  47. temporary database files. These files should be deleted automatically when
  48. the user quits the program.
  49.  
  50. In order to access the "Janitor" commands you need to have a privilege level
  51. of 200 or greater. Currently, the only janitor command is the "Cleanup" command
  52. which packs the events database file. When viewing an event users with
  53. privilege level 200 and up will also be able to see the name of the user
  54. that created an event.
  55.  
  56.  
  57. =============
  58. Parting Shots
  59. =============
  60.  
  61. There were lots of other things I had always planned to do with the code
  62. but I just never got around to it. I put it out in the TDBS world in hopes
  63. that someone else might do something wonderful with it. If you come up with
  64. some interesting let me know, I'd love to see what you've done!
  65.  
  66. Events! is freeware. Do with it what you will and use it in good health. You
  67. don't owe me a thing except to promise that you'll have a good time tearing
  68. it apart.
  69.  
  70. Have fun!
  71.  
  72. Tony Fardella
  73. P.O. Box 452
  74. Cotati, CA 94931
  75.  
  76. tonyf@crl.com
  77.  
  78.  
  79. =========
  80. Revisions
  81. =========
  82.  
  83. 2-4-96
  84.  
  85. After getting a few e-mail responses from people I was sufficiant inspired
  86. to do some major work to the Events! program. As a result I think that Events!
  87. is now in a semi-usable form. I took out the historical events database and
  88. added the ability to add, edit, display and delete events on any given day.
  89.  
  90. 2-7-96
  91.  
  92. Added feature to put an asterisk ("*") on days that have events scheduled
  93. in month view.
  94.  
  95. Fixed a few minor glitches with the Today and Jump functions.
  96.  
  97. Added the Next and Previous month functions to the help screen and reformated
  98. help screen a bit.
  99.  
  100. Changed verion number to 1.01 to reflect changes.
  101.  
  102. 2-19-96
  103.  
  104. Fixed the JUMP command so that it is aware of different centuries.
  105.  
  106. Made a few other cosmetic changes changing things like the color of
  107. the "Press any key..." prompt.
  108.  
  109. 2-21-96
  110.  
  111. Added an entry parameter to allow the sysop to set the minimum
  112. user level required to Add or Edit events in the database. Only
  113. user with a priviledge level greater than or equal to the edLevel
  114. may Add new events. The only user that created the event may edit
  115. or delete it. Those with priv level > 200 can edit or delete
  116. any events. To use this parameter put a slash (/) followed by
  117. the privilege level after the title of the calendar.
  118. The Add, Edit and Delete commands will only be shown to users with
  119. the proper privilege level.
  120.  
  121. If logged in with priv >= 200 you can now see the user ID
  122. of the user who created an event when viewing the events.
  123. Regular users do not see this info.
  124.  
  125. If logged in with priv >= 200 you have access to the "Janitor"
  126. commands. Currently, the only available command allows you to
  127. "Cleanup" or pack the database file. The Janitor commands will
  128. only be shown to users with privilege level 200 and above.
  129.  
  130. Added code to update the events database file if it was created
  131. by an older version of this program. Requires that the file
  132. DBUPDATE.TPG be in the same directory as the Events! program.
  133.  
  134. If the last day of the month had an event scheduled it wasn't
  135. being reflected in with an asterisk in the month view. This has been fixed.
  136.  
  137. 3-24-96
  138.  
  139. Integrated the historic events database back into the Events program. This
  140. is stored in the file HISTDB.DBF. All events in the database have the year
  141. set to 1900. Currently, there is no built-in way to add events in HISTDB.DBF.
  142.  
  143. 4-10-96
  144.  
  145. Added the ability to delete events from a range of dates at one time.
  146.  
  147. Changed the version number in the Help box to 1.02 to reflect the changes
  148. that have been made.
  149.  
  150.